EK-VT125-RC-001 


VT125 PROGRAMMING 
REFERENCE CARD 


CONTROL CHARACTERS RECEIVED 


Name 

Character 

Mnemonic 

Octal 

Code 

Function 

Null 

NUL 

000 

Ignored when received and 
used as a fill character. 

Enquire 

ENQ 

005 

Transmits the answerback 
message. 

Bell 

BEL 

007 

Generates a bell tone. 

Backspace 

BS 

010 

Moves the cursor to the left 
one character position. 

Horizontal 

Tab 

HT 

Oil 

Moves the cursor to the 
next tab stop. 

Line Feed 

LF 

012 

Causes a line feed or a new 
line operation. (Refer to 
Linefeed/ New Line mode.) 

Vertical 

Tab 

• VT 

013 

Processed as LF. 

Form Feed 

FF 

014 

Processed as LF. 

Carriage 

Return 

CR 

015 

Moves the cursor to left 
margin on the current line. 

Shift Out 

SO 

016 

Selects the G1 character 
set, as designated by a 
Select Character Set 
sequence. 

Shift In 

SI 

017 

Selects the GO character 
set, as designated by a 
Select Character Set 
sequence. 

Device 
Control 1 

DC1 

021 

Processed as XON. Causes 
the terminal to continue 
transmitting characters. 
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Name 

Character 

Mnemonic 

Octal 

Code 

Function 

Device 
Control 3 

DC3 

023 

Processed asXOFF. Causes 
terminal to stop transmit- 
ting all characters except 
XOFF and XON. 

Cancel 

CAN 

030 

If received during an 
escape or control se- 
quence, the sequence is 
cancelled and substitution 
character (§) is displayed. 

Substitute 

SUB 

032 

Processed as CAN. 

Escape 

ESC 

033 

Processed as a sequence 
introducer. 

Delete 

DEL 

1 77 

Ignored when received. 


ANSI COMPATIBLE SEQUENCES 


Set Mode 


Name 

Mnemonic 

Mode 

Sequence 

Line feed/new line 

LMN 

New line 

ESC 

20 h 

Cursor key 

DECCKM 

Application 

ESC [ ? 1 h 

ANSI/VT52 

DECANM 

ANSI 

N/A 


Column 

DECCOLM 

1 32 column 

ESC 

? 3 h 

Scrolling 

DECSCLM 

Smooth 

ESC 

? 4 h 

Screen 

DECSCNM 

Reverse 

ESC 

? 5 h 

Origin 

DECOM 

Relative 

ESC 

? 6 h 

Auto wrap 

DECAWM 

On 

ESC 

? 7 h 

Auto repeat 

DECARM 

On 

ESC 1 

? 8 h 


Reset Mode 


Name 

Mnemonic 

Mode 

Sequence* 

Line feed/new line 

LMN 

Line feed 

ESC 1 

20 1 

Cursor key 

DECCKM 

Cursor 

ESC 1 

? 1 1 

ANSI/VT52 

DECANM 

VT52 

ESC 1 

? 2 1 

Column 

DECCOLM 

80 column 

ESC 1 

[ ? 3 1 

Scrolling 

DECSCLM 

Jump 

ESC 1 

[ ? 4 1 

Screen 

DECSCNM 

Normal 

ESC 1 

[ ? 5 1 

Origin 

DECOM 

Absolute 

ESC 1 

[ ? 6 1 

Auto wrap 

DECAWM 

Off 

ESC 1 

[?7 1 

Auto repeat 

DECARM 

Off 

ESC 1 

[ ? 8 1 


The last character of each sequence is lowercase L(154g) 
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Cursor Key 

Codes Generated 




ANSI Codes 

VT52 Codes 

Cursor Key 

Reset 

Set 


(Arrow) 

(Cursor) 

(Application) 

Up 

ESC [ A 

ESC 0 A 

ESC A 

Down 

ESC [ B 

ESC 0 B 

ESC B 

Right 

ESC [ C 

ESC 0 C 

ESC C 

Left 

ESC [ D 

ESC 0 D 

ESC D 

Keypad Character Selection 



Name 

Mnemonic 


Sequence 

Alternate 

DECKPAM 


ESC = 

Numeric 

DECKPNM 


ESC > 


Keypad Codes Generated 



ANSI 

Mode 

VT52 Mode 


Numeric 

Alternate 

Numeric 

Alternate 


Keypad 

Keypad 

Keypad 

Keypad 

Key 

Mode 

Mode 

Mode 

Mode 

0 

0 

ESC 0 p 

0 

ESC? p 

1 

1 

ESC 0 q 

1 

ESC ? q 

2 

2 

ESC 0 r 

2 

ESC ? r 

3 

3 

ESC 0 s 

3 

ESC ? s 

4 

4 

ESC 0 t 

4 

ESC ? t 

5 

5 

ESC 0 u 

5 

ESC ? u 

6 

6 

ESC 0 V 

6 

ESC ? V 

7 

7 

ESC 0 w 

7 

ESC ? w 

8 

8 

ESC 0 X 

8 

ESC ? X 

9 

9 

ESC 0 y 

9 

ESC ? y 

— (minus) 

— (minus) 

ESC 0 m 

- (minus) t 

ESC ? m t 

, (comma) 

, (comma) 

ESC 0 1* 

, (comma)t 

ESC ? I*t 

. (period) 

. (period) 

ESC 0 n 

. (period) 

ESC ? n 

ENTER f: 

CR or CRLF 

ESC 0 M 

CR or CRLF 

ESC ? M 

PF1 

ESC 0 P 

ESC 0 P 

ESC P 

ESC ? P 

PF2 

ESC 0 Q 

ESC 0 Q 

ESC Q 

ESC ? Q 

PF3 

ESC 0 R 

ESC 0 R 

ESC R 

ESC ? R 

PF4 

ESC 0 S 

ESC 0 S 

ESC St 

ESC ? St 


* The last character of the sequence is lowercase L(154g) 
t These sequences were not available in the VT52. Do not use the 
PF4, " (minus), or''," (comma) keys with VT52 software, 
t Line feed/new line off causes ENTER to generate CR (01 5g). On 
causes ENTER to generate CRLF (01 5g 01 2g). 



Select Character Sets SCS 


Character Set 

GO Designator 

G1 Designator 

United Kingdom (UK) 

ESC ( A 

ESC ) A 

United States (USASCII) 

ESC ( B 

ESC ) B 

Special characters 

ESC ( 0 

ESC ) 0 

and line drawing set 



Alternate character ROM 

ESC ( 1 

ESC ) 1 

Alternate character ROM - 

ESC ( 2 

ESC ) 2 

special characters 



Name 

Mnemonic 

Sequence 

Single Shift 2 

SS2 

ESC N 

Single character shift 



to G2 (ASCII) 



Single Shift 3 

SS3 

ESC 0 


Single character shift 
to G3 (ASCII) 


NOTE: The VT125 generates the following control characters 
differently from previous DIGITAL terminals. 


Code VT125 Keys 


Previous Terminal Keys 

NUL CTRL - Space bar 

RS CTRL-~ 

US CTRL-? 

CTRL - @ 
CTRL - ^ 
CTRL 



Character Attributes 

Name 

Select Graphic Rendition 

Mnemonic 

SGR 

Sequence 

No attributes 



ESC [ 

m 

No attributes 

- 


ESC [ 

0 m 

Select bold attribute 




ESC 1 

1 m 

Select underline attribute 

- 


ESC 1 

4 m 

Select blink attribute 

- 


ESC 1 

5 m 

Select reverse video 
attribute 

— 


ESC 1 

[ 7 m 


NOTE: Without advance video option (AVO), only underline or reverse 
attribute is available. 
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Scrolling Region 

Name 

Mnemonic 

Sequence 

Set top and bottom margins 

DECSTBM 

ESC [ Pt ; Pb 

Cursor Movement Commands 

Name 

Mnemonic 

Sequence 

Cursor up 

cuu 

ESC [ Pn A 

Cursor down 

CUD 

ESC [ Pn B 

Cursor forward (right) 

CUF 

ESC [ Pn C 

Cursor backward (left) 

CUB 

ESC [ Pn D 

Cursor position 

CUP 

ESC [ PI ; Pc 

Cursor position (home) 

CUP 

ESC [ H 

Horizontal and vertical position 

HVP 

ESC [ PI ; Pc 

Horizontal and vertical position 

HVP 

ESC [ f 

(home) 

Index 

IND 

ESC D 

Reverse index 

Rl 

ESC M 

Next line 

NEL 

ESC E 

Save cursor (and attributes) 

DECSC 

ESC 7 

Restore cursor (and attributes) 

DECRC 

ESC 8 

Tab Stops 

Name 

Mnemonic 

Sequence 

Horizontal tab set 

HTS 

ESC H 

(at current column) 
Tabulation clear 

TBC 

ESC[ g 

(at current column) 
Tabulation clear 

TBC 

ESC [ 0 g 

(at current column) 
Tabulation clear (all tabs) 

TBC 

ESC [ 3 g 

Line Attributes 

Name 

Mnemonic 

Sequence 

Double-height top half 

DECDHL 

ESC # 3 

Double-height bottom half 

DECDHL 

ESC # 4 

Single-width single-height 

DECSWL 

ESC # 5 

Double-width single-height 

DECDWL 

ESC # 6 



Erasing 


Name 

Mnemonic 

Sequence 

Erase in line 

EL 

_ 

Cursor to end of line 

- 

ESC [ K 

Cursor to end of line 

- 

ESC [ 0 K 

Beginning of line to cursor 

- 

ESC [ 1 K 

Entire line containing cursor 

- 

ESC [ 2 K 

Erase in display 

ED 

_ 

Cursor to end of screen 

- 

ESC [ J 

Cursor to end of screen 

- 

ESC [ 0 J 

Beginning of screen to cursor 

- 

ESC [ 1 J 

Entire screen 

- 

ESC [ 2 J 

Communication and Graphics Protocol Commands 

Name 

Mnemonic 

Sequence 

Device control string 

DCS 

_ 

Enter ReGIS at previous 
command level 

- 

ESC P p 

Enter ReGIS at highest 
command level 

- 

ESC P 1 p 

Enter ReGIS at previous 
command level with 
commands to screen 


ESC P 2 p 

Enter ReGIS at highest 
command level with 
commands to screen 


ESC P 3 p 

Enter DECwriter graphics 

- 

ESC P q 

Enter VT1 05 emulator 

- 

ESC P t 

String terminator 

ST 

_ 

Exit graphics 

- 

ESC \ 

Media copy 

MC 

_ 

Turn off computer to auxiliary 
port 


ESC [ 4 i 

Turn on computer to auxiliary 
port 

~ 

ESC [ 5 i 

Turn off computer to screen 

- 

ESC [ 6 i 

Turn on computer to screen 

- 

ESC [ 7 i 

Select auxiliary port for 
ReGIS hardcopy output 


ESC [ ? 0 i 

Select computer port for 
ReGIS hardcopy output 

~ 

ESC [ ? 2 i 



Reports 


Name 

Mnemonic Sequence 

Device status report 

DSR 

ESC [ 5 n 

(request status of VT1 25) 



Response; 



Terminal OK 

DSR 

ESC [ 0 n 

Terminal not OK 

DSR 

ESC [ 3 n 

Device status report ' 

DSR 

ESC [ 6 n 

(request cursor position) 



Cursor position report 

CPR 

ESC [ PI ; Pc R 

Device attributes (what are you) 

DA 

. ESC [ c 

Device attributes (what are you) 

DA 

ESC [ 0 c 

Identify terminal (what are you) 

DECID ESC Z 

NOTE: ESC Z is not recommended. 


Device attributes 

DA 

See Note. 

response: VT1 25 



NOTE: Format is ESC [ ? 1 2 ; <vt1 00> 

; <vt1 25> ; <version> < 

<vt1 00> 


5 = no AVO, 7 = AVO 

<vt1 25> 


1 = printer, 0 = no print( 

<version> 


Graphics firmware 

Reset 



Name 

Mnemonic Sequence 

Reset to initial state 

RIS 

ESC c 
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VT100 Tests and Adjustments 

NOTE: Do not use VT100 loopback tests with the graphics processor 
installed. Loopback tests require test connector. Continuous tests end 
at failure or power-off. 


Name 

Mnemonic 

Sequence 

Screen alignment display 

DECALN 

- 


Fill screen with "Es” 

- 

ESC # 8 

Invoke confidence test 

DECTST 

- 


Power-up test 

- 

ESC 

2 ; 1 y 

Data loopback test 

- 

ESC 

2 ; 2 y 

Power-up and data loopback 
tests 


ESC 

2;3y 

ElA modem control loopback 
test 

- 

ESC 

; 2 ; 4 y 

Power-up and ElA loopback 
tests 

_ 

ESC 

2 ; 5 y 

Data loopback and ElA 
loopback tests 

— 

ESC 

2 ; 6 y 

Power-up, data loopback, 
and ElA loopback tests 


ESC 

2; 7 y 

Repeat power-up test 
continuously 


ESC 

2 ; 9 y 

Repeat data loopback test 
continuously 

~ 

ESC 

2 ; 10 

Repeat power-up and data 
loopback tests continuously 

~ 

ESC 

; 2 ; 1 1 

Repeat ElA test continuously 

- 

ESC 

2 ; 1 2 

Repeat power-up and ElA 
tests continuously 


ESC 

; 2 ; 13 

Repeat data loopback and ElA 
loopback tests continuously 

— 

ESC 

2 ; 14 

Repeat power-up, data 
loopback, and ElA loopback 
tests continuously 


ESC 

; 2 ; 1 5 


y 

y 

y 

y 

y 

y 
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VT125 Tests and Adjustments 

NOTE: AH tests require loopback connector. Always include power-up 
test for correct display of error indications. 


Name 


Mnemonic Sequence 


Invoke confidence test DECTST 
VT1 25 power-up test — 

VT1 25 computer port — 
data loopback test 
VT1 25 auxiliary port — 
data loopback test 
VT1 25 display test — 

VT1 25 video bit map — 
memory test 

Repeat any selected - 
tests continuously until 
power-off or failure 


ESC [ 4 ; 1 ; Ps . . . ; Ps y 
Ps= 1 
Ps= 2 

Ps= 3 

Ps= 4 
Ps= 5 

Ps= 9 


Keyboard Indicators 


Name 

Mnemonic 

Sequence 

Load LEDs 

DECLL 

_ 

All off 

- 

ESC [ q 

LI on 

- 

ESC [ 1 q 

L2 on 

- 

ESC [ 2 q 

L3 on 

- 

ESC [ 3 q 

L4 on 

- 

ESC [ 4 q 

VT52 COMPATIBLE MODE 

Mode 


Sequence 

Enter ANSI mode 


ESC < 

Keypad Character Selection 

Name 


Sequence 

Enter alternate keypad mode 


ESC = 

Exit alternate keypad mode 


ESC> 


(numeric keypad mode) 

NOTE: VT52 alternate keypad and numeric keypad modes are different 
from ANSI. 
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Character Sets 

Name Sequence 

Special graphics character set ESC F* 

Select US/UK character set ESC G 

(as determined by the US/UK 
character SET-UP feature) 

* Same as special character and line drawing set in ANSI mode. 

Cursor Position 


Name 


Sequence 


Cursor up* 

Cursor down* 

Cursor right* 

Cursor left* 

Cursor to home 
Direct cursor address 
Reverse line feed 


ESC A 
ESC B 
ESC C 
ESC D 
ESC H 

ESC Y PI Pet 
ESC It 


* Same when sent from the terminal. 

I Line and column numbers for direct cursor address are single 
character codes whose values are the desired number plus 31 ^q. 
Line and column numbers start at one. 

I The last character of the sequence is an uppercase i (1 1 1g). 


Erasing 


Name 


Sequence 


Erase to end of line ESC K 

Erase to end of screen ESC J 


Reports 

Name Sequence 


Identify (what are you) 
Response: VT52 


ESC Z 
ESC / Z 
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ReGIS COMMAND SUMMARY 
Position Command Summary 
Command 

P [] 

[<position>] 

<pixel vector> or <pv> 

(B) 

(S) 

(E) 

(W (<temp. writing controls>)) 

Vector Command Summary 
Command 

V [] 

[<position>] 

<pixel vector> or <pv> 

(B) 

(S) 

(E) 

(W (<temp. writing controls>)) 

Curve Command Summary 
Command 

C [<position>] 


(C) [<position>] 


(A<degrees>) [<position>] 


(A<degrees>C) [<position>] 


(B) [<pos>] . . . [<pos>] (E) 

(S) [ ] [<pos>]. . . [<pos>] [ ] (E) 
(W(<temp. writing controls>)) 


Function 

Reset pattern memory. 

Move to <position>. 

Move <multiplier> pixels in 
<pv> direction. 

Save current location. 

Save dummy location. 

Move to last saved location. 
P (W (M<multiplier>)). 


Function 

Draw dot at current position. 
Draw vector to <position>. 
Draw <multiplier> pixels in 
<pv> direction. 

Save current position. 

Save dummy position. 

Draw to last saved position. 


Function 

Circle with center at current 
position, circumference at 
<position>. 

Circle with center at 
<position>, circumference at 
current position. 

Arc with center at current 
position, starting at<position> 
for <degrees>. 

Arc with center at <position>, 
starting at current position for 
<degrees>. 

Bounded (closed) curve 
Unbounded (open) curve 
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Text Command Summary 
Command 


T (S <size number>) 

(H <height>) 

[<spacing>] 

(S [<width in pixels>,<height in pixels>)) 

(M [<width pixel multiplier>,<height pixel multiplier>]) 
(D <direction angle>) 

(D <string tilt> S <size> D <char tilt>) 

(T <italic degrees>) 

(A <pattern set number>) 

((B) <temporary attributes block> (E)) 

(W(<temp. writing controls>)) 

Writing Controls Summary 

Command Function 


W (C) 

(E) 

(R) 

(V) 

(F <foreground planes>) 


(I 0 or (D) ) 

1 (R) ) 

2 (G) ) 

3 (B) ) , 

(C) ) 

(Y) ) 

(M) ) 

(W) ) 

or 

(I (H <hue angle> 

L <lightness percent> 

S <saturation percent>)) 

(M <multiplier>) 

(N 1) 

(NO) 

(S 1) 

(SO) 

(S [.shading reference]) 

(S 'shading character) 

(P <binary pattern>) 

(P <pattern number>) 

(P (M <pattern multiplier>)) 
(W<i>(P<j>,N<k>)) 


Complement 

Erase 

Replace 

Overlay 

0 = no planes 

1 = plane 1 

2 = plane 2 

3 = planes 1 and 2 

Foreground intensity: 
Dark or Dark 

Dim grey Red 

Light grey Green 

White Blue 

Cyan 
Yellow 
Magenta 
White 


Pixels per <pv> 
Negative on 
Negative off 
Shading on 
Shading off 


Enter pattern. 

Use VT1 25 pattern. 

Custom writing control 
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Screen Controls Summary 

Command 

S <pixel vector> 

[<position>] 

(A [<position>J [<position>]) 

(E) 

(H [<position>] [<position>] 


(H(P[<position>])) 

(1 0 

or (D) 

1 

(R) 

2 

(G) 

3 

(B) 


(C) 


(Y) 


(M) 


(W) 

or 


(1 (H <hue angle> 


L <lightness percent> 

S <saturation percent>)) 

S(M<n>(<mono HLS>)(A<col( 

(S <scale>) 

(S (X<scale>Y<scale>) 

(T <ticks>) 

Macrograph 

Command 

@ . 

• keyletter character string @; 

keyletter 

Character Cell Control Summary 

Command 

L (A<integer>) 

(A''<name>'') 

''<ASCII char>” <hex pair> . . 
<hex pair>; 


Function 

Scroll. 

Display addressing. 

Erase screen. 

Hardcopy (corner positions 
optional) 

Set hardcopy offset. 

Background intensity: 

Dark or Dark 

Dim grey Red 

Light grey Green 

White Blue 

Cyan 
Yellow 
Magenta 
White 


HLS>)) Output mapping 


Time delay 


Function 

Clear all macrographs. 
Define macrograph. 
Invoke macrograph. 


Summary 

Select for loading. 
Give name to set. 
Load cell. 
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Report Command Summary 
Command 

R (L) 

(M (<keyletter>)) 

(M (=)) 

"<free>,<total>" 

(P) 


Function 

Set selected for loading. 
Contents of macrograph. 
Use of storage. 

Reply to use. 

Cursor position. 


1 St Edition, September 1 981 


Copyright ® 1981 by Digital Equipment Corporation. 
All rights reserved. 
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